home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Cream of the Crop 26
/
Cream of the Crop 26.iso
/
os2
/
tmail.zip
/
JFRQ103D.ZIP
/
JFREQ103.RAR
/
JFREQ.ESP
< prev
next >
Wrap
Text File
|
1996-06-22
|
49KB
|
1,117 lines
- - - - -
J F R e q
- - - - -
Procesador externo de File Request para FrontDoor,
MainDoor, Intermail o mailers compatibles y Remote Access, Maximus
o cualquier sistema de BBS basado en la estructura FILES.BBS
(C) 1994-96 Jordi Sesé (Fidonet 2:343/116)
versión 1.03
ATENCION
Este programa NO es, en modo alguno, de dominio público. Lee el
documento REGISTRO.TXT para conocer sus condiciones de uso.
Tabla de Contenidos
1. Introducción . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
1.1 ¿Qué es un procesador de File Request? . . . . . . . . . . . . . . 1
1.2 Características de JFReq 1.03 . . . . . . . . . . . . . . . . . . . 1
1.3 Ficheros en el paquete . . . . . . . . . . . . . . . . . . . . . . 2
2. Instalación . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
2.1 Actualización desde la versión 1.00 . . . . . . . . . . . . . . . . 4
2.2 Actualización desde la versión 1.01 . . . . . . . . . . . . . . . . 4
2.3 Actualización desde la versión 1.02 . . . . . . . . . . . . . . . . 4
2.4 Notas Generales . . . . . . . . . . . . . . . . . . . . . . . . . . 4
2.5 Sistemas Multilínea . . . . . . . . . . . . . . . . . . . . . . . . 5
2.6 Variables de entorno . . . . . . . . . . . . . . . . . . . . . . . 5
2.7 Instalación en el Mailer . . . . . . . . . . . . . . . . . . . . . 5
2.7.1 Configuración para MainDoor y MainDoor/2 . . . . . . . . . . . 6
2.7.2 Configuración para FrontDoor 2.1x y 2.2x . . . . . . . . . . . 6
2.7.3 Configuración para Intermail 2.27 . . . . . . . . . . . . . . . 7
2.7.4 Configuración para T-Mail . . . . . . . . . . . . . . . . . . . 7
2.7.5 Mailers compatibles con SRIF . . . . . . . . . . . . . . . . . 7
2.8 El programa de configuración . . . . . . . . . . . . . . . . . . . 7
2.8.1 Global Options . . . . . . . . . . . . . . . . . . . . . . . . 8
2.8.2 Time Settings . . . . . . . . . . . . . . . . . . . . . . . . . 9
2.8.3 Limits . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
2.8.4 Mail Addresses . . . . . . . . . . . . . . . . . . . . . . . 10
2.8.5 Template Editor . . . . . . . . . . . . . . . . . . . . . . . 10
3. Otros datos . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
3.1 Parámetros de la línea de comandos . . . . . . . . . . . . . . . 11
3.2 Variables utilizadas en las plantillas . . . . . . . . . . . . . 11
3.3 Formato de los ficheros de directorios y alias . . . . . . . . . 13
3.3.1 fichero de directorios: . . . . . . . . . . . . . . . . . . . 14
3.3.2 lista de ALIAS: . . . . . . . . . . . . . . . . . . . . . . . 14
3.3.3 Ejecución de programas on-line y el fichero de Alias . . . . 14
3.4 El compilador de nodelists . . . . . . . . . . . . . . . . . . . 15
3.5 El compilador del índice interno . . . . . . . . . . . . . . . . 15
3.6 El compilador de áreas de ficheros para Remote Access . . . . . . 16
3.7 Sistemas VIP . . . . . . . . . . . . . . . . . . . . . . . . . . 16
3.8 Informes Estadísticos . . . . . . . . . . . . . . . . . . . . . . 16
3.9 Peticiones especiales con mensaje incluído . . . . . . . . . . . 17
3.10 Soporte de ficheros TIC . . . . . . . . . . . . . . . . . . . . 18
3.11 Comandos del editor . . . . . . . . . . . . . . . . . . . . . . 18
3.12 Pruebas en local . . . . . . . . . . . . . . . . . . . . . . . . 18
3.13 Colaboradores . . . . . . . . . . . . . . . . . . . . . . . . . 19
3.14 Cómo contactar con el autor . . . . . . . . . . . . . . . . . . 19
i
Sección 1
Introducción
1.1 ¿Qué es un procesador de File Request?
Hasta hace un tiempo, los mailers buscaban por una lista de directorios
aquellos ficheros que se les pedían en cada File Request, pudiendo tardar
poco o mucho, ya que la búsqueda era totalmente secuencial. Ahora, tanto
FrontDoor (2.1x ó 2.2x), MainDoor (0.94) o Intermail (2.27) permiten la
ejecución instantánea de una utilidad externa que localice rápidamente en
los índices de ficheros de la BBS los ficheros, generando al tiempo un
informe de respuesta o cualquier otra cosa.
JFReq busca en los índices de las bases de ficheros de Maximus o Remote
Access, incrementando en el último caso los contadores de download de cada
fichero pedido. El uso de los índices ya existentes de la BBS hace que su
instalación sea muy rápida, y su mantenimiento nulo, ya que es la propia
BBS la que realiza el mantenimiento.
1.2 Características de JFReq 1.03
* Versiones nativas de ejecutable para DOS y OS/2
* Soporte Multilínea
* Programa de configuración muy fácil de usar.
* Mailers soportados: FrontDoor, MainDoor, InterMail, T-Mail y aquellos
que soporten SRIF.
* BBSs e índices soportados: Maximus (2.x y 3.x), Remote Access (2.x)
* Otros BBS o Doors soportadas vía un índice propio a partir de listados
tipo FILES.BBS, con limitaciones por nivel y password.
* listado de directorios y ficheros de Alias (con o sin passwords)
* Limitaciones por cantidad de ficheros, KBytes, minutos por sesión o
día, velocidad mínima y horario
* Cinco tipos de sesiones, protegidas (con password), sistemas
listados, sistemas no listados, sistemas VIP (totalmente
configurables) y happy hour (horario especial para sesiones sin
password), pudiendo definir límites para cada tipo de sesión por
separado.
* Posibilidad de comprobar la existencia de los sistemas en un
índice de nodelist propio
* Asimilación de seguridad de la sesión a un nivel de
usuario en la BBS
* Limitación de acceso a sistemas non-gratos o con cadenas
sospechosas
* Informe de respuesta y mensajes de error totalmente
1
Sección 1. Introducción 2
configurables mediante plantillas
* Informes y mensajes configurables según zona y/o red del sistema que
realiza la petición
* Envío de mensajes adicionales si se pide algún fichero especial
* Envío de ficheros .TIC referentes a los ficheros pedidos
* Ejecución de programas on-line para registros o procesos en remoto
* Control interno para evitar envíos duplicados en una misma sesión
* Control interno de comprobación de errores de transmisión
* Soporta y utiliza Download Counters y Passwords en Remote Access
* Soporte automático para Download Counters en Maximus y en FILES.BBS
* Soporte de ficheros y áreas libres de ratio
* Buffering para archivos situados en unidades de acceso crítico
(CD-ROMs, etc.)
* Realización de informes estadísticos en pantalla o como mensaje
(Netmail o en un área de mensajes determinada)
1.3 Ficheros en el paquete
100to101.COM Programa de actualización de la versión 1.00 a la 1.01
101to102.COM Programa de actualización de la versión 1.01 a la 1.02
102to103.COM Programa de actualización de la versión 1.02 a la 1.03
STCONV.COM Programa de actualización de estadísticas si actualizas
de la versión 1.00 ó 1.01 (DOS)
STCONVP.EXE Programa de actualización de estadísticas si actualizas
de la versión 1.00 ó 1.01 (OS/2)
JFREQ.DOC Manual de uso de JFReq en inglés
JFREQ.ESP Manual de uso de JFReq en castellano
JFREQP.EXE Ejecutable principal de JFReq para OS/2
JFRQCFGP.EXE Versión OS/2 del programa de configuración de JFReq
JFREQ.EXE Ejecutable principal de JFReq para DOS
JFREQCFG.COM Versión DOS del programa de configuración de JFReq
JFNCP.EXE Compilador de Nodelist, versión OS/2
JFNC.COM Compilador de Nodelist, versión DOS
JFNC.CTL Fichero de control de nodelists
JFFCP.EXE Compilador de índice secundario de ficheros. Versión OS/2
JFFC.COM Compilador de índice secundario de ficheros. Versión DOS
JFFC.CTL Fichero de control para el índice secundario de ficheros
JFSTATP.EXE Generador de informes estadísticos, versión OS/2
JFSTAT.COM Generador de informes estadísticos, versión DOS
LDATP.EXE Lista el contenido del fichero JFREQ.DAT (OS/2)
LDAT.COM Lista el contenido del fichero JFREQ.DAT (DOS)
DEFAULT.FRQ Plantilla de respuesta por defecto
*.FRQ Plantillas de ejemplo
FNAMES.DAT Fichero de control de peticiones de ficheros especiales
REGISTER.TXT Información de uso y registro de JFReq. Inglés
REGISTRO.TXT Información de uso y registro de JFReq. Castellano
UADDRESS.DAT Fichero de control por direcciones de sistemas non-gratos
UMAILERS.DAT Fichero de control por cadenas de sistemas non-gratos
JFREQ.CFG Fichero de Configuración
JFREQ.DAT Fichero de datos (nodos)
JFNC.NDX Indice de nodelists
JFFILES.IDX Indice de ficheros secundario
JFAREA.DAT Indice de áreas
??#???.IDX Estadísticas del día (índice)
Sección 1. Introducción 3
??#???.DAT Estadísticas del día (datos)
ACUM.IDX Indice de las estadísticas acumuladas
ACUM_F.DAT Estadísticas acumuladas (ficheros)
ACUM_N.DAT Estadísticas acumuladas (nodos)
Sección 2
Instalación
2.1 Actualización desde la versión 1.00
Ejecute 100to101.com para actualizar el fichero de configuración a la
versión 1.01. Si es usuario de la versión DOS, borre el fichero
JFREQ.COM. Después, lea y aplique el siguiente apartado.
2.2 Actualización desde la versión 1.01
a) Ejecute la utilidad 101to102.com para actualizar el fichero JFREQ.CFG a
la versión 1.02.
b) Ejecute la utilidad STCONV.com (STCONVP.exe en OS/2) para convertir su
información estadística al nuevo formato.
c) lea y aplique el siguiente apartado.
2.3 Actualización desde la versión 1.02
a) Desempaquete su archivo de la versión 1.03 en el directorio de JFReq,
sin sustituir sus archivos originales de configuración.
b) Ejecute la utilidad 102to103.com para actualizar el fichero JFREQ.CFG a
la nueva versión.
c) Si mantiene un indice interno, ejecute JFFC.com (JFFCP.exe en OS/2)
para actualizarlo
d) Si mantiene el índice espacial para Remote Access, ejecute JFRAFC
(JFRAFCP en OS/2) para actualizarlo
d) Ejecute el programa de configuración de JFReq para comprobar que sus
datos son correctos y echar un vistazo a las nuevas opciones.
2.4 Notas Generales
JFReq funciona en procesadores 286 o superior. En la mayoría de
instalaciones bajo DOS, es necesaria la presencia de SHARE o equivalente.
Para evitar cualquier problema en la ejecución, añada el directorio de
JFReq a su variable de entorno PATH.
4
Sección 2. Instalación 5
Utilice los listados de directorios para aquellos ficheros y / o
directorios que NO estén en su índice del BBS. Intente que sean los menos
posibles, ya que son los que representan un mayor tiempo de búsqueda.
El índice auxiliar es para aquellos sistemas que tengan DOORs especiales
de ficheros, o que posean un software de BBS diferente a RA o Maximus.
Este índice es adicional a los otros, por lo que si no disponde ni de RA
ni Maximus, deje en blanco el campo del path del BBS y seleccione Remote
Access como tipo de BBS.
De este modo, JFReq puede llegar a buscar, en una sola petición de
ficheros, en un fichero de Alias, un listado de directorios, un índice de
la BBS y el índice propio. Racionalice su sistema para permitir la
búsqueda más rápida posible, evitando buscar varias veces en el mismo
sitio.
2.5 Sistemas Multilínea
Tan sólo es necesario tener correctamente definidas las variables de
entorno TASK y JFREQ para que la ejecución de JFReq en un sistema
multilínea sea correcta. JFReq mantiene un fichero LOG para cada tarea
(llamado JFREQ@.LOG, donde @ es el valor de TASK), que abre en modo
exclusivo para prevenir errores en la configuración. Los demás ficheros
se abren en modo compartido.
2.6 Variables de entorno
TASK Nº de tarea actual. Evita colisiones, ya que por
ejemplo, el nombre del fichero LOG depende de ella. Cada
fichero LOG lleva al final el número de tarea en la que
se ejecuta. Si no está definido se asume tarea cero
(monolínea)
JFREQ Indica el directorio de programa para JFReq. Util para
configuraciones multilinea con diferentes directorios de
arranque. No precisa la barra invertida final. Se
aconseja utilizarla, aunque el directorio de ejecución
sea el mismo.
ejemplos:
SET TASK=1
SET JFREQ=C:\JFREQ
Si se usa MainDoor, la variable MD deberá apuntar al directorio
correspondiente.
2.7 Instalación en el Mailer
ATENCION: No utilicéis paths demasiado largos para paquetes y entrada de
ficheros en vuestra configuración del mailer. Estos paths se pasarán
después a JFReq en la línea de comando, y por la limitación de 128
Sección 2. Instalación 6
caracteres que impone el sistema operativo podría ocurrir que no se
reconociera completamente la línea de comando.
ATENCION: Colocar la línea EXACTAMENTE IGUAL. Tan sólo puede variar el
nombre del ejecutable (JFREQ para DOS, JFREQP.EXE para OS/2), y el camino
de ejecución del mismo (si es necesario).
2.7.1 Configuración para MainDoor y MainDoor/2
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ File Request │░░░░░░░░░░░░░░░░░
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ Swap┌─── File Request ────┐░░░░░░░░░░░░
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░│ Ento│ Ficheros │░░░░░░░░░░░░
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░└─────│ Límites │░░░░░░░░░░░░
░░░░░░░░░░░░░░░░░░ Copyright (c) 19│ Procesador │ppa. ░░░░░░░
┌──────────────────────────────── File Req - FRQP ────────────────────
│ Programa jfreq /MD =F =R =T =X =B =H =D =W
│ Activo Si
│ Swapping Si
└─────────────────────────────────────────────────────────────────────
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░
Nota: en algunas versiones de MainDoor, el parámetro =W aún no está
soportado. Este parámetro es opcional, por lo que no afectará a su
funcionamiento.
2.7.2 Configuración para FrontDoor 2.1x y 2.2x
▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║ ╔═══════════════════╗▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║ ║ ║▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
▒╔════════════════════════════════════════════════ Request processor ╗
▒║
▒║ Program jfreq /FD =F =R =T =X =B =H =D =W░░░░░░░░░░░░░░░░░░░░░░░░░
▒║ Enabled Yes
▒║ Swapping Yes
▒║
▒╚════════════════════════════════════════════════════════════════════
▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║ Swapping ║▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
▒▒▒▒▒▒▒▒ Copyright ║ Protection ║mrighausen; All rights reserved
▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒║ Fax ║▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒╚══════════════════╝▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
Sección 2. Instalación 7
2.7.3 Configuración para Intermail 2.27
╔══════════════════════════════════════════════════════ File requests
║
║ Mode Anyone can request
║ List C:\IM\SYSTEM\OKREQDIR.LST
║ Alias
║ Message
║ Max match 0
║ Max time 0
║ Max size 0
║ Min speed 300
║ Limited No
║ Start 00:00
║ End 00:00
║ Days -------A
║ External JFREQ /IM %A %F %X %B %M %D %O░░░░░░░░░░░░░░░░░░░░░░░░░░░░
║
╚═════════════════════════════════════════════════════════════════════
2.7.4 Configuración para T-Mail
Hace falta añadir una línea similar a la siguiente en su fichero
T-Mail.Ctl:
Process Freq JFREQ /TM <busy.t-m> *F <packets_dir>\T-$$-*T\RESPONSE.FRQ *H
siendo:
<busy.t-m> el path completo al fichero (nombre incluido) 'Busy Flag
file', tal como esté definido en T-Mail.Ctl
<packets_dir> el directorio para almacenar paquetes de T-Mail, tal como
esté definido en T-Mail.Ctl
2.7.5 Mailers compatibles con SRIF
Tan sólo ha de ejecutar JFReq pasándole el parámetro /SRIF, junto con el
fichero de información generado por el Mailer:
JFREQ /SRIF <srif info file>
Compruebe la documentación de su mailer para averiguar la macro a utilizar
en su caso en vez del texto entre corchetes. Si su versión de MainDoor
soporta SRIF, utilice /MDS en vez de /SRIF para indicárselo a JFReq.
2.8 El programa de configuración
El menú de configuración es muy sencillo y se explica a sí mismo cuando
situamos el cursor sobre la opción a ejecutar. Las opciones que aparecen
con una <+> a su derecha, no están disponibles a menos que el programa
esté registrado. Consulta el fichero REGISTRO.TXT para conocer la forma
de registro.
Sección 2. Instalación 8
2.8.1 Global Options
Permite cambiar los valores comunes a toda sesión, como son:
BBS Type - selecciona el tipo de BBS,
BBS Path - directorio principal de la BBS,
Use Custom Index - usar o no el índice secundario de ficheros.
utilice esta opción para soportar doors de
CD-ROMs o bien otros programas de BBS basados en
la estructura FILES.BBS (en este último caso,
seleccione Remote Access como tipo de BBS y deje
en blanco el campo BBS Path)
Download Counters - tipo de soporte para contadores de download.
Escoja cualquiera de las opciones (diferente a
no) para activarlo en Remote Access. Este soporte
se extiende al índice adicional. Los contadores
de download DEBEN existir para que JFReq los
actualice.
Min. Baud Rate - velocidad mínima para poder establecer
peticiones,
PKT Directory - directorio para paquetes de respuesta (se
recomienda usar un disco RAM si se dispone de él)
LOG Directory - directorio donde crear los ficheros de LOG
Special Requests - editar el fichero que contiene la lista de
ficheros a los que añadir un mensaje especial. El
formato es tan simple como <FICHERO> (nombre
parcial o total sin comodines) <path
completo\mensaje>. Se pueden usar cualquiera de
los tokens disponibles. Si se desea enviar algún
mensaje adicional siempre, coloque un punto (.)
como nombre de fichero.
Nodelist Lookup - activar / desactivar la comprobación en el indice
de nodelist del programa
Nodelist Files - editar la lista de nodelists a procesar cuando se
ejecuta JFNC, el compilador de nodelists
Allow Outbound Req. - permitir o no peticiones de ficheros que se
producen en llamadas salientes (cuando es tu
sistema el que realiza la llamada)
Buffered Drives - unidades de las que realizar buffering (copiar
los ficheros a disco duro antes de la
transferencia)
Buffering Path - vía de acceso en que realizar la copia temporal
de ficheros de CD-ROMs, etc.
Keep Statistics - activar / desactivar el almacenamiento de datos
estadísticos para posteriores informes.
Expand Wildcards - enviar o no más de un fichero por petición, en el
caso de que ésta contenga algún carácter comodín.
CC to Sysop - si desea recibir una copia (como Netmail) del
mensaje(s) enviados al sistema remoto.
Inbound Directory - directorio donde situar los .PKTs de las copias
para ser procesados por su procesador de correo.
Sección 2. Instalación 9
2.8.2 Time Settings
Ajuste del horario
Start Time - hora de inicio para permitir peticiones,
End Time - hora de finalización,
Happy H. Start - inicio del periodo Happy Hour
Happy H. End - fin del periodo Happy Hour
2.8.3 Limits
Fija los límites según el tipo de sesión. En un primer nivel, tenemos:
Listed / Unsecure - sesiones con sistemas listados o con los que
no hemos concertado ningún password
Unlisted - sesiones con sistemas no listados en nuestras
nodelists
Passworded - sesiones 'protegidas' con sistemas con password
concertado. da igual si éstos estan listados o no
Happy Hour - sesiones con sistemas sin password (listados o no)
en un periodo determinado de tiempo
VIP Systems - editar la lista de especificaciones para sistemas
VIP. Consulte la sección Sistemas VIP para
conocer el formato.
Unwanted Systems - dos ficheros que contienen las cadenas a comprobar
tanto en la dirección como en la información de
los sistemas para detectar aquellos sistemas que
por alguna razón no sean bienvenidos. consulte el
apartado comandos del editor para conocer las
teclas disponibles dentro de la ventana de
edición de ficheros.
Dentro de cada uno de estos apartados (excepto el de sistemas non-gratos,
en el que editamos un par de ficheros), las opciones son las siguientes:
Alias List File - fichero que contiene los nombres especiales de
ficheros y sus equivalencias, con o sin passwords
(ver más adelante su formato)
Directory List - lista de ficheros y directorios (con o sin
password). Se utiliza para proteger ficheros o
directorios con un password, o para añadir
directorios que no constan en la base de ficheros
del BBS (ver más adelante su formato)
Level for BBS Access - nivel de usuario de BBS al que equiparamos el
tipo de sesión, para limitar el acceso a las
áreas del BBS
Maximum Time - máximo tiempo a permitir en una sesión. el tiempo
a utilizar se calcula a partir de la velocidad en
baudios de la llamada
Maximum Size - máximo tamaño acumulado a permitir en una sesión
Maximum Files - número máximo de ficheros a transmitir en una
sesión
Max Time per Day - máximo tiempo por día
Max Size per Day - máximo tamaño por día
Max Files per Day - número máximo de ficheros por día
Sección 2. Instalación 10
NOTAS:
a) si se deja el límite a cero, significa que no existe
limitación en ese apartado
b) si se deja en blanco el apartado de fichero de directorio o
alias, se desactiva esa comprobación para ese tipo de
sesiones
2.8.4 Mail Addresses
Definición de la dirección de correo principal y hasta 17 secundarias
(AKAs)
2.8.5 Template Editor
Permite editar las plantillas desde el fichero de configuración,
seleccionando el fichero (mostrando su ámbito de actuación al pie),
separando los apartados de:
Error Messages - edita uno a uno los posibles mensajes de error
del sistema
Template - editar la plantilla a enviar en todas las
peticiones permitidas
Bad Template - editar la plantilla a enviar en caso de coincidir
los datos del sistema con alguna de las cadenas
definidas en el apartado 'Unwanted Systems'
Consulte el apartado 'comandos del editor' para conocer las teclas
disponibles dentro de la ventana de edición de ficheros.
Sección 3
Otros datos
3.1 Parámetros de la línea de comandos
Esta es una descripción de los parámetros que se pasan a JFREQ desde el
mailer en la línea de comandos. Estos parámetros corresponden al Mailer,
no a JFReq. JFReq lee la línea tal como la genera el Mailer al traducir
los parámetros. Es imprescindible que la línea de comandos de JFReq sea
tal y como se especifica para cada tipo de Mailer. No se puede alterar el
orden de los parámetros.
Modo de Operación:
/MD MainDoor
/FD FrontDoor
/IM InterMail
/TM T-Mail
/SRIF compatible SRIF
/MDS MainDoor en modo SRIF
Modo FD/MD:
=F Fichero de información del sistema remoto
=R Fichero que contiene los ficheros pedidos
=T Fichero a crear con los ficheros a transmitir
=X SECURE/UNSECURE
=B Velocidad de conexión en BPS
=H Minutos hasta el siguiente evento que no acepte FREQs
=D INBOUND/OUTBOUND (dirección de la llamada)
=W LISTED/UNLISTED
Modo Intermail:
%A Dirección de correo del sistema remoto
%F Fichero que contiene los ficheros pedidos
%X SECURE/UNSECURE/UNLISTED
%B Velocidad de conexión en BPS
%M Minutos hasta el siguiente evento que no acepte FREQs
%D INBOUND/OUTBOUND (dirección de la llamada)
%O Nombre del SysOp del sistema remoto
3.2 Variables utilizadas en las plantillas
El uso de plantillas de respuesta es una de las características
principales del programa, ya que permiten personalizar totalmente el
mensaje de respuesta.
11
Sección 3. Otros datos 12
Estos ficheros tienen la extensión .FRQ, y en su nombre contienen la clave
para definir a qué sistemas se enviarán. Veamos unos ejemplos, puestos en
el mismo orden que se realiza la selección:
2#343.FRQ -> se enviará a todos los sistemas de la zona 2,
red 343.
2#34@.FRQ -> se enviará a todos los sistemas de la zona 2,
abarcando aquellas redes que no tengan plantilla
definida y comiencen por 34.
2.FRQ -> se enviará a todos los sistemas de la zona 2 que
no tengan otra plantilla definida.
DEFAULT.FRQ -> se enviará a todos los sistemas de cualquier
zona que no tengan ninguna plantilla definida.
Este fichero DEBE existir para una correcta
ejecución del programa.
MYPOINTS.FRQ -> se enviará a todos los sistemas que cuya AKA
corresponda a un punto de nuestro sistema.
Si existen ficheros con el mismo nombre, pero con la extensión .FRP, estos
se enviarán en vez de los de extensión .FRQ si el sistema llamante muestra
en su AKA principal una dirección en punto.
Para crear una nueva plantilla, copie la plantilla existente que más se
parezca a la nueva a un fichero con el nombre correspondiente al juego de
direcciones a los que se lo desea enviar. En futuras versiones del
programa, esta función estará integrada en la configuración.
Si bien cualquiera de estas plantillas pueden ser editadas con cualquier
editor ASCII, ya que los ficheros están suficientemente comentados,
recomendamos utilizar el mismo programa de configuración, ya que facilita
enormemente la labor.
NOTAS:
a) La justificación de párrafos se realiza eliminando espacios
extra y líneas en blanco, y adecuando la longitud de cada
línea a un máximo de 75 caracteres.
b) Es importante que el juego de mayúsculas/minúsculas en los
tokens se mantenga en las plantillas tal como se lista aquí.
Las variables utilizables en las plantillas son las siguientes:
Token Valor/Acción
---------------------------------------------------------------------
@@BegJust Indica el comienzo de un párrafo justificado.
@@EndJust Indica el final de un párrafo justificado.
@@FileDesc A partir de esta línea se coloca el listado de ficheros
y sus descripciones.
@@FrqSyst Nombre del sistema remoto
@@FrqName Nombre completo del SysOp del sistema que hace el File
Request.
@@FrqAddr Dirección electrónica del sistema que hace el File
Request.
@@FrqFrom Localidad desde donde llama el sistema remoto
@@FrqPhon Teléfono del sistema remoto
@@FrqSPWD Password de sesión (en blanco si no lo hay)
Sección 3. Otros datos 13
@@FrqSerN Número de serie del Mailer remoto.
@@SesType Tipo de Sesión en curso (secure/unsecure/unlisted/happy
hour)
@@PrgName Nombre y versión actual del programa JFReq en uso.
@@RegName Nombre de usuario tal como consta en el fichero llave de
registro del programa JFReq.
@@AKMatch Aka del propio sistema que coincide con la del sistema
que realiza el File Request, o la primaria, si no existe
coincidencia.
@@RegAKA<#> Dirección electrónica del sistema. Sustituir <#> por el
nº de AKA en la configuración.
@@MinBaud Velocidad mínima de conexión en Baudios permitida.
@@BegTime Hora de inicio de FileRequest permitidos en el sistema
(formato 24 Hrs).
@@EndTime Hora de finalización de FileRequest permitidos en el
sistema (formato 24 Hrs).
@@BegHapp Hora de inicio del horario especial para FileRequest en
el sistema (formato 24 Hrs).
@@EndHapp Hora de finalización del horario especial de FileRequest
en el sistema (formato 24 Hrs).
@@OkFiles Número de ficheros localizados (no gratuitos).
@@TKbytes Ks totales de los ficheros localizados (no gratuitos).
@@TFreeKB Ks totales en ficheros gratuitos
@@OkFFree Número de ficheros gratuitos localizados
@@CumCall Número de llamadas totales del sistema remoto
@@CumFile Número de ficheros pedidos por el sistema remoto (acum.)
@@CumSize Ks pedidos por el sistema remoto (acumulado)
@@CumTime Minutos acumulados por el sistema remoto
@@DayFile Total de ficheros pedidos hoy por el sistema remoto
@@DaySize Ks. pedidos hoy por el sistema remoto
@@DayTime Total de minutos usados hoy por el sistema remoto
@@MaxFile Máximo número de ficheros permitidos en esta sesión
@@MaxSize Máximo de Ks permitidos para esta sesión.
@@MaxTime Tiempo máximo de transmisión para esta sesión.
@@Ma<#>File Máximo de ficheros para ese tipo de sesión
@@Ma<#>Size Máximo tamaño (en Ks) para ese tipo de sesión
@@Ma<#>Time Máximo tiempo (minutos) para ese tipo de sesión
@@Da<#>File Máximo de ficheros por día para ese tipo de sesión
@@Da<#>Size Máximo de Ks por día para ese tipo de sesión
@@Da<#>Time Máximo de minutos por día para ese tipo de sesión
En los seis últimos tokens, debe sustituir <#> por:
L - sesiones con sistemas listados (sin password)
U - sesiones con sistemas no listados
H - sesiones con sistemas sin password durante el periodo happy
hour
P - sesiones protegidas por un password de sesión
A - tipo de sesión en la llamada activa
3.3 Formato de los ficheros de directorios y alias
Estos ficheros pueden ser diferentes según el tipo de sesión y han de
contener una entrada por línea, procurando no dejar líneas en blanco y
siguiendo este formato lo más adecuadamente posible.
Sección 3. Otros datos 14
3.3.1 fichero de directorios:
para representar ficheros:
<disco>:\<path>\<nombre>.<ext> [!<password>]
para representar directorios:
<disco>:\<path> [!<password>]
ejemplo:
C:\FICHEROS\SECRETO.ZIP !seguro
3.3.2 lista de ALIAS:
<alias>[$] [!<pwd>] <disco>:\<path>\<nombre>.<ext> [<disco>:\<path>\...]
ejemplos:
LAS_BETAS !seguro C:\FICHEROS\SECRETO.* C:\FICHEROS\NOTAS.ZIP
FILES$ C:\FILES\FILELIST.ZIP
Para indicar que un alias es gratuito, basta con añadir el signo dollar
('$') al nombre del alias.
(los passwords en la lista de alias y en la de directorios son opcionales)
3.3.3 Ejecución de programas on-line y el fichero de Alias
Para indicar que el MAGIC corresponde a la ejecución de un programa
on-line, se deberá usar el siguiente formato en el fichero de ALIAS:
<on-line_magic>% <type> <response_file> <prg_command_line> [<parameters>]
siendo:
<on-line_magic> el magic name
<type> alguno de los siguientes:
PKT --> el fichero de respuesta es un .PKT estándar
que se mandará tal cual al usuario remoto y
será borrado por el mailer tras enviarlo.
ATT --> el fichero de respuesta se enviará tal cual
está sin realizar modificación alguna, y será
borrado una vez enviado.
MSG --> el fichero de respuesta es un texto ASCII,
que debe ser convertido por JFReq para ser
mandado como un mensaje.
<response_file> el fichero re respuesta, resultado de la ejecución del
programa
<prg_command_line> la línea de comandos para el programa a ejecutar.
<parameters> (opcional) demás parámetros añadidos a la petición de
ejecución que serán añadidos a la línea de comandos
para el programa antes de los especificados por el
usuario.
El usuario, para pedir la ejecución del programa on-line, deberá hacer una
petición similar a la siguiente:
Sección 3. Otros datos 15
%PRG=<program_alias> <program_parameters>
siendo <program_alias> el MAGIC correspondiente al programa y pudiendo
añadir los parámetros necesarios a continuación.
NOTA PARA USUARIOS DE OS/2:
Si tenéis algún problema para ejecutar vuestros programas on-line dentro
de la propia ventana de JFReq/2, o deseáis usar un archivo .CMD para mayor
comodidad, deberéis usar un paquete como HSTART (o similar) para crear una
nueva ventana para vuestro proceso, usando los parámetros adecuados para
que suspendiera la ventana de JFReq y le retornara el control tras la
ejecución (/C y /WAIT en HSTART). Un ejemplo de cómo usarlo en la
definición del programa en el fichero de alias sería:
LISTADOR% MSG c:\pkt\fichero.res HSTART /C /WAIT listador.cmd
3.4 El compilador de nodelists
El programa JFNC.COM (JFNCP.EXE en OS/2) nos sirve para compilar las
nodelists actuales tal como están definidas en el fichero JFNC.CTL,
creando un índice especial para que JFReq pueda conocer lo más rápidamente
posible si un sistema está o no listado.
Esta comprobación, obviamente, se toma su tiempo, por lo que se recomienda
comprobar si el mailer realiza ya ésta función, en cuyo caso se
desactivará la opción 'Nodelist Lookup'.
Recuerde ejecutar el programa compilador de nodelists cada vez que éstas
cambien, ya que si no lo hace la comprobación no tiene sentido.
El fichero JFNC.CTL ya está comentado, por lo que no debe tener problemas
en cuanto a su estructura
3.5 El compilador del índice interno
Para poder utilizar el índice interno, deberá crear un fichero ASCII
(JFFC.CTL), siguiendo el siguiente formato para cada una de las líneas:
[!<pwd>] [#[$]<level>] <down. path> <files.bbs path> <desc. column>
[!<password>] (opcional) password para todos los ficheros del área
[#<user level>] (opcional) nivel de usuario para poder acceder al área en
formato numérico, siguiendo esta tabla si usa el modo de Maximus:
0 - Disgrace Si usa el modo Remote Access, tan sólo ha
1 - Limited de colocar la misma cifra que pondría en
2 - Normal RACONFIG o JFREQCFG.
3 - Worthy
4 - Privil
5 - Favoured
6 - Extra
7 - Clerk
Sección 3. Otros datos 16
8 - AsstSysop
9 - SysOp
NOTA: Las áreas de ficheros con un signo dollar ($) delante del nivel de
usuario se considerarán gratuitas.
Para actualizar el índice, ejecute JFFC(P) siempre que sea necesario.
3.6 El compilador de áreas de ficheros para Remote Access
Es posible usar un índice adicional para RA que acelera considerablemente
el tiempo de búsqueda. Este índice debe actualizarse al menos una vez al
día si hay variaciones en las áreas de ficheros de RA. Si no existe el
índice, la búsqueda se realiza usando los índices estándar de RA. El
compilador de índices de RA se llama JFRAFC.EXE y precisa que esté la
variable de entorno RA definida. El fichero de índice resultante se llama
RAFILES.IDX y ha de estar en el directorio base de JFREQ.
3.7 Sistemas VIP
JFREQ permite definir sesiones con sistemas determinados, basándose en la
dirección principal del sistema que realiza la llamada. Este control de
sesiones se realiza a través del fichero JFREQ.VIP, cuyo formato se
describe a continuación:
Syst. Address BBS Lev. MaxTime MaxSize MaxFile DayTime DaySize DayFile
------------- -------- ------- ------- ------- ------- ------- -------
@2:343/116.* 300 60 5000 25 0 0 0
2:343/129.0 300 60 5000 25 0 0 0
2:343/117.0 300 60 5000 25 0 0 0
'@' colocado delante de una dirección indica que la sesión debe ser con
password para considerar a ese sistema como VIP.
Los niveles de usuario de BBS se guían por la misma tabla que se aplica a
la configuración del índice interno (JFFC). Consulte el apartado
correspondiente en caso de duda.
Las direcciones que se usen deben ser 4D (incluyendo número de punto).
Pueden usarse caracteres comodín en cualquier lugar de la dirección,
ampliando el número de sistemas a los que se aplica la condición de VIP
siguiendo la pauta del comodín.
Si indica '0' en algún campo de limitación (excluído el de nivel del BBS),
JFREQ interpretará que no existe límite en ese parámetro concreto.
3.8 Informes Estadísticos
JFSTAT(P) es el programa a ejecutar para obtener información estadística
acerca de los pedidos de ficheros a su sistema. Esta información es de
todo su sistema. Si desea saber los pedidos de cada línea en particular,
consulte los LOGs de cada tarea.
Sección 3. Otros datos 17
La sintaxis del programa puede ser:
a) informar en un fichero PKT, a NETMAIL o de Echo.:
JFSTAT(P) /PKT <to> <area> <inbound path> [days to report] [days to purge]
<to> a quién irá destinado el mensaje, usando el carácter de subrayado
para los espacios (e.g. Joe_Sysop)
<area> es NETMAIL para correo Net o el TAG del área a la que se desea
enviar los informes
<inbound path> es su path de entrada de paquetes de correo, para colocar
allí el fichero PKT, que será procesado luego por su procesador de correo.
b) informe a pantalla:
JFSTAT [days to report] [days to purge]
[days to report] días en que se basa la estadística.
[days to purge] después de realizar la estadística, sólo se mantendrá la
información correspondiente a los últimos días especificados en esta
cifra. Eg. si se especifica 4, se borrará toda la información de cinco o
más días de antigüedad. Si especifica 0, se borrará toda la infomación
estadística. La información de los LOGs o de los nodos no resultará
afectada.
c) Si ejecuta JFSTAT sin argumentos, se le dará por pantalla un informe de
todos los datos estadísticos acumulados.
3.9 Peticiones especiales con mensaje incluído
JFReq permite añadir mensajes específicos al paquete de respuesta si el
sistema remoto se lleva un determinado fichero. Estos mensajes pueden
utilizar los mismos tokens que en los mensajes normales de respuesta.
Para activar esta opción, tan sólo ha de editar el fichero FNAMES.DAT
desde el programa de configuración, en el apartado Special Requests,
dentro de las opciones globales. En este fichero, deberá especificar el
nombre de fichero (pudiendo usar comodines), a cotejar con los que se
llevan los sistemas, junto con un nombre de fichero (con su path completo)
que corresponda con el mensaje que desee adjuntar. Este mensaje se
enviará junto con el normal de respuesta, dentro del mismo paquete de
correo. Por ejemplo, si definimos la siguiente línea dentro de
FNAMES.DAT:
*.JPG c:\jfreq\gifjpg.msg
Se adjuntará el fichero gifjpg.msg (convirtiendo los tokens que contenga),
al paquete de respuesta de todo sistema que nos pida un fichero con
extensión JPG.
Sección 3. Otros datos 18
3.10 Soporte de ficheros TIC
JFReq es capaz de generar y enviar un fichero .TIC con cada fichero
pedido. Este fichero .TIC, al ser completo, debería ser compatible con
cualquier procesador de ficheros. Para activar esta función, el sistema
que hace la petición deberá añadir a los ficheros pedidos, estas macros,
como si fueran dos ficheros más:
%TIC=<area>
%PWD=<password>
Siendo <area> el nombre del área de ficheros y <password> el definido para
nuestro sistema en el procesador de ficheros del sistema remoto.
3.11 Comandos del editor
El programa de configuración de JFReq incorpora un sencillo editor de
textos para facilitarle la edición de algunos ficheros importantes en la
configuración de su sistema. Aparte de los cursores y otras teclas cuya
función se presupone, estas son otras teclas que puede utilizar dentro del
editor, con su función correspondiente:
Ctrl+flecha der - coloca el cursor en la siguiente palabra
Ctrl+flecha izq - coloca el cursor en la palabra anterior
Ctrl+fin - borra desde el cursor hasta el final de la línea
Ctrl+inicio - borra desde el cursor hasta el inicio de la línea
Ctrl+retroceso - borra la línea entera (se puede recuperar con Alt+R)
Ctrl+AvPag - mueve el cursor al final del documento
Ctrl+RePag - mueve el cursor al inicio del documento
Alt+S - copia el contenido de la línea actual en memoria
Alt+R - restaura la última línea copiada o borrada
Alt+X - finaliza la edición, guardando el fichero
3.12 Pruebas en local
Si desea realizar pruebas de funcionamiento de JFReq en local, siga el
siguiente proceso:
a) Cree un fichero con un contenido similar a éste, que sera el de
información del sistema remoto imaginario:
----> principio de srif.nfo <----
Sysop Juan Martin Perez
AKA 2:343/116.117@fidonet.org
Baud 28800
Time 1440
RequestList c:\jfreq\fich.req
ResponseList c:\jfreq\trans.req
RemoteStatus unprotected
SystemStatus listed
----> fin de srif.nfo <----
Sección 3. Otros datos 19
b) Cree otro fichero que se corresponda con el incluído anteriormente en
el apartado 'RequestList', que contendrá los ficheros a pedir:
----> principio de fich.req <----
FILES
%TIC=PRUEBAS
%PWD=CLAVE
NENA.GIF
MAX300?.*
----> fin de fich.req <----
c) Ejecute JFReq utilizando la siguiente línea de comando:
JFREQ /SRIF srif.nfo
d) Si ha seguido el ejemplo, en el mismo directorio de JFReq se le habrá
creado el fichero TRANS.REQ, que contendrá las vías de acceso de los
ficheros a enviar, así como de un .PKT y, en caso que lo haya activado en
la prueba, los ficheros .TIC correspondientes a las peticiones realizadas.
Consulte con un editor o un listador ASCII estos ficheros TIC/PKT. Del
mismo modo, puede consultar el LOG para comprobar la correcta ejecución
del programa.
3.13 Colaboradores
Mi más sincero agradecimiento a las siguientes personas, que han realizado
las pruebas y comentarios pertinentes para hacer de JFReq un sistema lo
más estable posible en multitud de configuraciones:
Ignacio Plasencia Rafael Gutiérrez
Rafael Suárez Fidel León
Francisco Sedano Tony Saá
David Sáez Eduard Sánchez Biete
Tirs Abril Carlos Hermida
José Gonzalvo Jose Luis Hernández
Dave Carter
(y muchos más que me dejo...)
3.14 Cómo contactar con el autor
Envía tus comentarios constructivos sobre el producto vía correo
electrónico a:
Jordi Sese,
BlackAdders' BBS: 34-3-2103303 (24Hr. V34, VFC, FAX)
Fidonet: 2:343/116.0
RedBBS: 757:101/25
Internet: shel@black.lonestar.es
o por correo ordinario a:
Jordi Sesé
C/ Sostres 31, Atico 1
Sección 3. Otros datos 20
08024 Barcelona
(Spain)
Si eres un usuario registrado, puedes utilizar estos mismos medios para
realizar aquellas consultas que precises para una correcta utilización del
programa. Si no estás registrado todavía, lee el fichero REGISTRO.TXT
para conocer las condiciones de uso de JFReq y cómo convertirse en un
usuario registrado de este programa.
- Fin de JFReq.Doc -